###User Defined Function###
_WinAPI_CreateDIB

###Description###
Erzeugt eine unkomprimierte geräteunabhängige Bitmap (DIB) mit der angegebenen Breite, Höhe und Farbtiefe.

###Syntax###
#include <WinAPIGdi.au3>
_WinAPI_CreateDIB ( $iWidth, $iHeight [, $iBitsPerPel = 32 [, $tColorTable = 0 [, $iColorCount = 0]]] )

###Parameters###
@@ParamTable@@
$iWidth
	Die Breite des Bitmaps in Pixeln.
$iHeight
	Die Höhe des Bitmaps in Pixeln. Wenn dieser Wert positiv ist, so ist die Bitmap eine von unten nach oben DIB und ihr Ursprung ist die linkere untere Ecke, anderenfalls ist die Bitmap eine von oben nach unten DIB und ihr Ursprung befindet sich in der oberen linken Ecke.
$iBitsPerPel
	[optional] Die Anzahl an Bits welche jedes einzelne Pixel und die maximale Anzahl an Farben in der Bitmap beschreiben. Standard ist 32.
$tColorTable
	[optional] Eine "dword[n]" Struktur welche die DIB Farbtabelle repräsentiert.
	Die Anzahl an Farben in der Tabelle hängt von den Werten des $iBitsPerPel Parameters ab.
$iColorCount
	[optional] Die Anzahl an Farbindexen in der DIB Farbtabelle welche tatsächlich von der Bitmap verwendet werden.
	Der Wert des Parameters sollte nicht die Anzahl an Farben in der Farbtabelle, auf welche von dem $pColorTable Parameter gezeigt wird, überschreiten. Standard ist 0.
@@End@@

###ReturnValue###
@@ReturnTable@@
Erfolg:	Das Handle des DIBs.
Fehler:	0 und setzt @error auf einen ungleich 0 Wert.
@@End@@

###Remarks###
Wenn die Bitmap monochromatisch (1 Bit pro Pixel), so sollte die Farbtabelle zwei Einträge enthalten.
Wenn keine Farbtabelle angegeben wurde, so erstellt diese Funktion eine monochromatische Bitmap mit schwarz und weiß als Farben. Wenn die Bitmap 4 doer 8 Bits pro Pixel verwendet, so sollte die Farbtabelle bis zu 16 oder respektive 256 Einträge enthalten.
In diesem Falle, sofern die Farbtabelle nicht angegeben wurde, wird die Funktion eine leere Farbtabelle erzeugen (alle Farben sind schwarz) mit der maximal möglichen Anzahl an einträgen für die angegebene Farbtiefe.
Man kann später die Farbtabelle mittels der <a href="_WinAPI_SetDIBColorTable.htm">_WinAPI_SetDIBColorTable()</a> Funktion ausfüllen.
Wenn die Bitmap 16, 24 oder 32 Bits pro Pixel verwendet, so wird die Farbtabelle nicht verwendet und der $tColorTable wird ignoriert.

Diese Funktion erstellt keine komprimierte 16, 24, oder 32 Bits pro Pixel Bitmaps welche das "biCompression" Mitglied der $tagBITMAPINFO Struktur ist immer 0 ($BI_RGB).

Wenn die Arbeit mit der Bitmap abgeschlossen ist, so sollte man sie mit der <a href="_WinAPI_DeleteObject.htm">_WinAPI_DeleteObject()</a> Funktion zerstören.

Um einen Pointer zum aktuellen Standort der DIB Bit Werte zu  bekommen sollte man <a href="_WinAPI_GetExtended.htm">_WinAPI_GetExtended()</a> verwenden.

###Related###
_WinAPI_DeleteObject, _WinAPI_GetExtended

###Example###
@@IncludeExample@@
